home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / xeq.arc / XEQ.DOC < prev   
Text File  |  1987-02-20  |  4KB  |  86 lines
  1. COMMENT *
  2.  
  3.  
  4.                    XEQ
  5.                -----
  6.        XEQ - COM File Library and Command Executor
  7.  
  8. This program allows COM files to be stored inside XEQ's code and executed
  9. by the command:
  10.     XEQ command
  11. For example, if BEEP.COM has been added to XEQ then:
  12.     XEQ BEEP
  13. will execute the BEEP program stored inside XEQ. The original BEEP.COM
  14. can be removed from the hard disk (onto a backup floppy!!!). If the
  15. specified command is not in XEQ it is passed to the DOS for execution as
  16. if directly typed at the DOS prompt.
  17.  
  18. PURPOSE
  19.     The purpose is to prevent wasted hard-disk space by those pesky
  20. little COM files we don't seem to be able to do without. When hard disks
  21. are formatted they are given an allocation size (called a cluster size)
  22. and this is typically 2048 or 4096 bytes. So when you save a 7 byte
  23. COM file like BEEP.COM, it takes up a full cluster. By combining these
  24. COM files into this program or LIBRARY, several COM files can be stored
  25. in one file (the XEQ program itself) and still accessed without this waste
  26. in hard disk space.
  27.  
  28. In order to make the body of XEQ as small as possible, only a limited
  29. number of options are available. They are
  30.  
  31.     XEQ [/R]<command> Execute <command> if it is in the library
  32.                 or passes it to DOS for execution if not
  33.     XEQ /A(command>   Add <command>.COM to library if not existant
  34.     XEQ /D<command>   Delete command from library if existant
  35.     XEQ /E<command>   Extract command from library to .COM file if existant
  36.     XEQ /L        List the <commands> in the library
  37.  
  38. When the /E switch is used to extract a COM file, a full path for the
  39. resulting file may be specified. If the file already exists at that location,
  40. extraction does not occur. The extracted file has the same date stamp as the
  41. COM file it was originally stored from.
  42.  
  43. LIMITATIONS
  44.     As a COM file can only be 64K long, command COM files cannot
  45. be added to XEQ if this figure would be violated, as XEQ is a COM file
  46. itself. The /L command indicates the amount of space left and any
  47. attempt to add a file which would exceed the 64k limit is prevented. Any
  48. number of COM files can be added until this number is reached.
  49.         When a command is added or deleted from XEQ, a new copy of XEQ must
  50. be rewritten to disk. This is always written to the current drive
  51. and directory regardless of where the original copy of XEQ was found
  52. (it may have been loaded from elsewhere because of DOS's path
  53. capability). Therefore to update the original copy of XEQ, the /D or /A
  54. commands should be performed in the drive and directory of the
  55. original. If not, then the original copy of XEQ will still exist in its
  56. original location and the updated version in the current drive and
  57. directory.
  58.     The new version of XEQ will always be called XEQ.COM, regardless
  59. of whether the original program was called XEQ.COM or not. It is
  60. intended that only one library XEQ.COM will exist on the system. This
  61. is based on the likelihood that the sum of all the small COM files
  62. will not exceed the 64K limit of the XEQ.COM library file. Several COM
  63. libraries can exist on the same system by renaming an XEQ.COM to
  64. something else.
  65.     However, this appears cumbersome as it would be necessary to remember
  66. which commands are in which library. Also any add or delete from the
  67. renamed library file results in the new copy being called XEQ.COM. Care
  68. would have to be taken to prevent the overwriting of a legitimate
  69. XEQ.COM, and the new XEQ.COM would have to be renamed to the original
  70. name of the revised library.
  71.  
  72. USAGE TIP:
  73.     The CED utility and its synonym feature can make the use of XEQ
  74. transparent in use. For example, if BEEP.COM is stored inside XEQ then a 
  75. synonym like
  76.     SYN BEEP XEQ BEEP
  77. will cause BEEP to be run out of the XEQ file just by entering BEEP.
  78.  
  79. Disclaimer:
  80.     Hardwood Software Associates guarantees XEQ.COM will do NOTHING
  81. useful at all. You use it at your own risk (make backups of the COM files
  82. stored within XEQ before deleting them from your hard disk). However, it
  83. seems to perform as described here and may be of use to you.
  84.  
  85. ======================================================================
  86. *